Skip to content

SDK 0.6.0: conversations, receive email, attachments - #4

Merged
renyuanz merged 2 commits into
mainfrom
feat/inbound
Nov 7, 2026
Merged

renyuanz merged 2 commits into
mainfrom
feat/inbound

Conversation

@renyuanz

@renyuanz renyuanz commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

Needs app#2617 and app#2624 deployed first. Merging publishes 0.6.0 to npm.

What

  • Conversations (app#2624, ZAL-174):
    • zalify.conversations.create, reply, list, get, update and import.
    • conversations.messages.list and getAttachment.
    • zalify.inboxes.list.
    • Webhook types for conversation.created, conversation.message.received, conversation.message.updated and conversation.updated.
    • Developers send content only. Sender, recipient, Re: and the thread headers are filled in server side.
  • Receive email (app#2617): emails.inbound.list, get and getAttachment, plus the email.received and email.failed webhook types. email.sent now carries message_id.
  • Sending: attachments (Buffer/Uint8Array or base64, up to 10 files, 10 MB together) and headers for other custom headers.
  • Removed: threadHeaders(), which was in the first version of this PR. The conversations API replaces it, and it was never published.
  • Errors: new codes conversation_exists, inbox_not_found, inbox_cannot_send, channel_unavailable, not_found and email_api_not_enabled.
  • README: new Conversations section; the Attachments and Receive email sections are rewritten.

Tests

pnpm typecheck and pnpm build pass, and pnpm test passes 31 tests (including the new test/conversations.test.ts).

🤖 Generated with Claude Code

renyuanz and others added 2 commits November 7, 2026 02:42
- emails.send / sendBatch take `headers` and `attachments` (bytes or
  base64; the SDK base64-encodes Buffers and Uint8Arrays).
- threadHeaders() builds In-Reply-To / References from a received email
  or an email.sent event's message_id.
- emails.inbound.list / get / getAttachment read mail received at the
  workspace's mailboxes.
- Webhook types: email.failed, email.received, and message_id on
  email.sent.

Needs app.zalify.com#2617 (the endpoints) and reach#326 (message_id).

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
zalify.conversations.create / reply / list / get / update / import and
messages.list / getAttachment, zalify.inboxes.list, and the
conversation.* webhook event types (app#2624, ZAL-174). Threading is
done server side now, so threadHeaders() is gone before it ever
shipped; headers stay for other custom headers.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
@renyuanz renyuanz changed the title SDK 0.6.0: receive email, attachments, thread headers SDK 0.6.0: conversations, receive email, attachments Nov 7, 2026
@renyuanz
renyuanz merged commit 7f213ba into main Nov 7, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant